home *** CD-ROM | disk | FTP | other *** search
/ IRIX Installation Tools & Overlays 1999 May / SGI IRIX Installation Tools & Overlays 1999 May - Disc 2.iso / relnotes / infosearch / ch2.z / ch2
Text File  |  1999-04-19  |  19KB  |  392 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        2.  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  9.  
  10.        This chapter lists information that is supplemental to the
  11.        _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e.  The information listed
  12.        here is product-specific; use it with the Installation Guide
  13.        to install this product.
  14.  
  15.        2.1  _I_n_f_o_S_e_a_r_c_h__S_u_b_s_y_s_t_e_m_s
  16.  
  17.        The InfoSearch product includes these subsystems:
  18.  
  19.        _i_n_f_o_s_e_a_r_c_h._b_o_o_k_s._h_e_l_p         Information Searching Help
  20.  
  21.        _i_n_f_o_s_e_a_r_c_h._i_n_d_e_x._b_o_o_k_s        Search Index for Online Books
  22.                                      and Help
  23.  
  24.        _i_n_f_o_s_e_a_r_c_h._i_n_d_e_x._m_a_n          Search Index for Man Pages
  25.  
  26.        _i_n_f_o_s_e_a_r_c_h._i_n_d_e_x._r_e_l_n_o_t_e_s     Search Index for Release Notes
  27.  
  28.        _i_n_f_o_s_e_a_r_c_h._m_a_n._e_o_e            Information Searching Manual
  29.                                      Pages
  30.  
  31.        _i_n_f_o_s_e_a_r_c_h._m_a_n._r_e_l_n_o_t_e_s       Information Searching Release
  32.                                      Notes
  33.  
  34.        _i_n_f_o_s_e_a_r_c_h._s_w._b_a_s_e            Information Searching Base
  35.                                      Environment
  36.  
  37.        _i_n_f_o_s_e_a_r_c_h._s_w._e_o_e             Information Searching
  38.                                      Execution Environment (client)
  39.  
  40.        _i_n_f_o_s_e_a_r_c_h._s_w._s_e_r_v_e_r          Information Searching Server
  41.                                      Environment
  42.  
  43.  
  44.        2.2  _I_n_f_o_S_e_a_r_c_h__S_u_b_s_y_s_t_e_m__D_i_s_k__S_p_a_c_e__R_e_q_u_i_r_e_m_e_n_t_s
  45.  
  46.        This section lists the subsystems (and their sizes) of the
  47.        InfoSearch software.
  48.  
  49.        You can use the software installation instructions in the
  50.        _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e to install this product.
  51.        If you are installing this software for the first time, the
  52.        default subsystems are installed if you click the _I_n_s_t_a_l_l
  53.        _A_u_t_o_m_a_t_i_c_a_l_l_y button.  To install a different set of
  54.        subsystems, click the _C_u_s_t_o_m_i_z_e _I_n_s_t_a_l_l_a_t_i_o_n button and make
  55.        your new selections.  Then click the _S_t_a_r_t button to launch
  56.        the installation.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        Note:  The listed subsystem sizes are approximate. Refer to
  75.               the _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for information
  76.               on finding exact sizes.
  77.  
  78.        Subsystem Name                      Subsystem Size
  79.                                            (Kilobytes)
  80.        _i_n_f_o_s_e_a_r_c_h._b_o_o_k_s._h_e_l_p (_d_e_f_a_u_l_t)           580
  81.        _i_n_f_o_s_e_a_r_c_h._i_n_d_e_x._b_o_o_k_s                  19100*
  82.        _i_n_f_o_s_e_a_r_c_h._i_n_d_e_x._m_a_n                    20356*
  83.        _i_n_f_o_s_e_a_r_c_h._i_n_d_e_x._r_e_l_n_o_t_e_s                1224*
  84.        _i_n_f_o_s_e_a_r_c_h._m_a_n._e_o_e (_d_e_f_a_u_l_t)               48
  85.        _i_n_f_o_s_e_a_r_c_h._m_a_n._r_e_l_n_o_t_e_s (_d_e_f_a_u_l_t)          36
  86.        _i_n_f_o_s_e_a_r_c_h._s_w._b_a_s_e (_d_e_f_a_u_l_t)              604
  87.        _i_n_f_o_s_e_a_r_c_h._s_w._e_o_e (_d_e_f_a_u_l_t)               248
  88.        _i_n_f_o_s_e_a_r_c_h._s_w._s_e_r_v_e_r (_d_e_f_a_u_l_t)           1716
  89.  
  90.  
  91.  
  92.        * Approximate subsystem size. Index information from files
  93.        not loaded on the system disk will be removed from the index
  94.        and those files not found in the index that reside on the
  95.        local system will be added to the index. This will occur at
  96.        system reboot time.
  97.  
  98.  
  99.  
  100.        2.3  _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d
  101.  
  102.        All of the subsystems for InfoSearch can be installed using
  103.        IRIX.  You do not need to use the miniroot. Refer to the
  104.        _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for complete installation
  105.        instructions.
  106.  
  107.  
  108.        2.4  _P_r_e_r_e_q_u_i_s_i_t_e_s
  109.  
  110.        Your workstation must be running the latest version of IRIX
  111.        6.5 in order to use this release of InfoSearch.
  112.  
  113.        The infosearch.index subsystems require that the
  114.        sgsearch.sw.base subsystem is installed.
  115.  
  116.        infosearch.sw.eoe requires that webviewer.sw.eoe and
  117.        websupport_eoe.sw.lib are installed.
  118.  
  119.        Although you can build and update the InfoSearch database
  120.        without the infosearch.sw.server subsystem, this subsystem
  121.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                                   - 3 -
  132.  
  133.  
  134.  
  135.        is required if you wish to connect to the given machine to
  136.        view the content that is present.
  137.  
  138.        In order to view the Online books, infosearch.sw.server
  139.        requires that dynaweb.sw.eoe be installed.
  140.  
  141.  
  142.  
  143.        2.5  _C_o_m_p_a_t_i_b_i_l_i_t_y
  144.  
  145.        InfoSearch is compatible with all supported forms of SGI
  146.        documentation.  Using a version 1.x InfoSearch client
  147.        application to access InfoSearch content from an InfoSearch
  148.        server that has been updated to version 2.x is _n_o_t
  149.        _s_u_p_p_o_r_t_e_d.
  150.  
  151.  
  152.        2.6  _O_t_h_e_r__I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  153.  
  154.  
  155.  
  156.        2.6.1  _C_o_n_f_i_g_u_r_a_t_i_o_n__F_i_l_e_s
  157.  
  158.        Changing /usr/lib/infosearch/C/infosrch.cfg to add new
  159.        document/information domains is not currently supported.
  160.  
  161.  
  162.        2.6.2  _I_n_f_o_S_e_a_r_c_h__S_e_r_v_e_r__I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  163.  
  164.        Upon completion of the InfoSearch server installation
  165.        (infosearch.sw.server), a series of links are established
  166.        into what InfoSearch believes to be your HTTP (web) server's
  167.        default CGI (Common Gateway Interface) and document root
  168.        directories.
  169.  
  170.        The following commands are performed as part of the exit
  171.        operation following the install:
  172.  
  173.            #### llllnnnn ----ssss ////uuuussssrrrr////lllliiiibbbb////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////bbbbiiiinnnn////iiiinnnnffffoooossssrrrrcccchhhh....ccccggggiiii ////vvvvaaaarrrr////wwwwwwwwwwww////ccccggggiiii----bbbbiiiinnnn////iiiinnnnffffoooossssrrrrcccchhhh....ccccggggiiii
  174.            #### llllnnnn ----ssss ////uuuussssrrrr////lllliiiibbbb////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////CCCC  ////vvvvaaaarrrr////wwwwwwwwwwww////hhhhttttddddooooccccssss////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////CCCC
  175.            #### llllnnnn ----ssss ////uuuussssrrrr////lllliiiibbbb////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////CCCC////iiiinnnnddddeeeexxxx....sssshhhhttttmmmmllll ////vvvvaaaarrrr////wwwwwwwwwwww////hhhhttttddddooooccccssss////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////iiiinnnnddddeeeexxxx....sssshhhhttttmmmmllll
  176.            #### llllnnnn ----ssss ////uuuussssrrrr////lllliiiibbbb////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////CCCC////iiiinnnnddddeeeexxxx....hhhhttttmmmmllll  ////vvvvaaaarrrr////wwwwwwwwwwww////hhhhttttddddooooccccssss////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////iiiinnnnddddeeeexxxx....sssshhhhttttmmmmllll
  177.  
  178.        These are necessary for InfoSearch to run properly. If your
  179.        HTTP (web) server's default CGI location _O_R your HTTP
  180.        server's document root differ from the defaults shown above
  181.        (/var/www/cgi-bin/; /var/www/htdocs/), please execute the
  182.        commands shown above (as root) from a shell with the correct
  183.        values substituted.
  184.  
  185.        In order to view the Online books and Help information,
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                                   - 4 -
  198.  
  199.  
  200.  
  201.        infosearch.sw.server requires that dynaweb.sw.eoe be
  202.        installed.  Refer to the _D_y_n_a_w_e_b _r_e_l_e_a_s_e _n_o_t_e_s for the
  203.        proper setup and installation of that product.
  204.  
  205.  
  206.  
  207.        2.6.3  _S_e_t_t_i_n_g__u_p__a__L_o_c_a_l__I_n_f_o_S_e_a_r_c_h__S_e_r_v_e_r
  208.  
  209.        To create an InfoSearch server, install all the books, help
  210.        books, man pages and relnotes on the machine you wish to be
  211.        the server. To install all the documentation, follow this
  212.        procedure in inst(1M), for each CD:
  213.  
  214.            IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll ****....mmmmaaaannnn....****
  215.            IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll ****....bbbbooooooookkkkssss....****
  216.  
  217.        Next, install the following subsystems:
  218.  
  219.            IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh....sssswwww....bbbbaaaasssseeee iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh....sssswwww....sssseeeerrrrvvvveeeerrrr ssssggggsssseeeeaaaarrrrcccchhhh....sssswwww....bbbbaaaasssseeee
  220.            IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh....iiiinnnnddddeeeexxxx....mmmmaaaannnn
  221.            IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh....iiiinnnnddddeeeexxxx....bbbbooooooookkkkssss
  222.            IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh....iiiinnnnddddeeeexxxx....rrrreeeellllnnnnooootttteeeessss
  223.  
  224.        It is recommended that you reboot your machine after
  225.        installing these images.  This will trigger the databases to
  226.        begin to initialize themselves.  This initialization will
  227.        take serveral minutes once the system has rebooted.
  228.  
  229.        See the next section for more details.
  230.  
  231.        The InfoSearch server and available content can now be
  232.        accessed via a web browser such as _n_e_t_s_c_a_p_e(1) (preferred
  233.        method) or via the InfoSearch client. Use the URL
  234.        http://<hostname>/infosearch/ where <hostname> is the name
  235.        of the server. To access the server from the InfoSearch
  236.        client, use the same designation, or simply the server name.
  237.  
  238.        If the indexes become damaged or out of sync, they can be
  239.        rebuilt (from scratch) as follows:
  240.  
  241.           #### ////uuuussssrrrr////lllliiiibbbb////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////bbbbiiiinnnn////ssssggggiiiinnnnddddeeeexxxxAAAAddddmmmmiiiinnnn ----ffffoooorrrrcccceeee ----uuuuppppddddaaaatttteeee
  242.  
  243.        2.6.4  _s_g_i_n_d_e_x_A_d_m_i_n__a_n_d__M_a_i_n_t_a_i_n_i_n_g__a_n__I_n_f_o_S_e_a_r_c_h__D_a_t_a_b_a_s_e
  244.  
  245.        _s_g_i_n_d_e_x_A_d_m_i_n(1) is the utility program used to keep your
  246.        InfoSearch database(s) in sync. In other words, what is
  247.        installed on your system should match what is indexed and
  248.        referenced by the InfoSearch database(s).  The program
  249.        _s_g_i_n_d_e_x_A_d_m_i_n performs that function and can be run from the
  250.        command line, as root. See the _s_g_i_n_d_e_x_A_d_m_i_n(1) man page for
  251.        details.
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.                                   - 5 -
  264.  
  265.  
  266.  
  267.        When your machine is rebooted, _s_g_i_n_d_e_x_A_d_m_i_n is run
  268.        automatically.  It checks to verify if new content has been
  269.        installed and updates your InfoSearch database(s) in the
  270.        background (running in the process queue under a very low
  271.        priority).
  272.  
  273.        Although you can build and update the InfoSearch database
  274.        without the infosearch.sw.server subsystem, this subsystem
  275.        is required if you wish to connect to the given machine to
  276.        view the content that is present.
  277.  
  278.        Note:  If you have installed or removed additional/optional
  279.               products that included documentation (man pages,
  280.               release notes or online books) and your machine has
  281.               not been rebooted, you may need to run _s_g_i_n_d_e_x_A_d_m_i_n
  282.               from the shell to put your InfoSearch database(s) in
  283.               sync with the content recently installed or removed
  284.               from your disk.
  285.  
  286.        InfoSearch attempts to make an educated guess at when
  287.        content may have been installed. It does a quick check of
  288.        the _i_n_s_t(1M) history file (/var/inst/hist) and compares it's
  289.        system modification date to the system modification date of
  290.        the InfoSearch index file(s). If the index files' date is
  291.        less than that of the _i_n_s_t(1M) history file, a warning
  292.        message will be printed on the main InfoSearch page when the
  293.        interface is invoked/accessed. This warning appears below
  294.        the search text field, and acts as a friendly reminder to
  295.        the administrator that _s_g_i_n_d_e_x_A_d_m_i_n may need to be run. An
  296.        example of this warning message follows:
  297.  
  298.            TTTThhhheeee sssseeeeaaaarrrrcccchhhhaaaabbbblllleeee iiiinnnnddddeeeexxxx ffffiiiilllleeeessss ffffoooorrrr tttthhhheeee ddddaaaattttaaaabbbbaaaasssseeeessss ffffoooouuuunnnndddd oooonnnn tttthhhhiiiissss sssseeeerrrrvvvveeeerrrr
  299.            mmmmaaaayyyy bbbbeeee oooouuuuttttddddaaaatttteeeedddd.... PPPPeeeerrrrhhhhaaaappppssss ttttrrrryyyy aaaannnnooootttthhhheeeerrrr sssseeeerrrrvvvveeeerrrr ((((tttteeeecccchhhhppppuuuubbbbssss....ssssggggiiii....ccccoooommmm)))) oooorrrr
  300.            uuuuppppddddaaaatttteeee yyyyoooouuuurrrr iiiinnnnddddeeeexxxx wwwwiiiitttthhhh ssssggggiiiinnnnddddeeeexxxxAAAAddddmmmmiiiinnnn????
  301.  
  302.        If necessary, _s_g_i_n_d_e_x_A_d_m_i_n can be run (as root) from the
  303.        shell as follows:
  304.  
  305.            #### ////uuuussssrrrr////lllliiiibbbb////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////bbbbiiiinnnn////ssssggggiiiinnnnddddeeeexxxxAAAAddddmmmmiiiinnnn ----uuuuppppddddaaaatttteeee
  306.  
  307.        2.6.5  _F_i_l_e_s__N_o_t__L_i_s_t_e_d__b_y__'_v_e_r_s_i_o_n_s_'
  308.  
  309.        Local index files local<domain>.{ttl, dct, idx, inv} and the
  310.        table-of-contents (<domain>*.html) files are generated by
  311.        _s_g_i_n_d_e_x_A_d_m_i_n(1). See the FILES section of the
  312.        _s_g_i_n_d_e_x_A_d_m_i_n(1) man page for further details.
  313.  
  314.  
  315.        2.6.6  _E_r_r_o_r_s__A_c_c_e_s_s_i_n_g__t_h_e__S_e_r_v_e_r
  316.  
  317.        InfoSearch utilizes server-side parsed HTML (.shtml) files
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.                                   - 6 -
  330.  
  331.  
  332.  
  333.        upon startup. If your HTTP (web) server is not configured
  334.        properly to handle these types of files, you may see the
  335.        following error in the InfoSearch client application (or
  336.        your web browser):
  337.  
  338.            [[[[aaaannnn eeeerrrrrrrroooorrrr ooooccccccccuuuurrrrrrrreeeedddd wwwwhhhhiiiilllleeee pppprrrroooocccceeeessssssssiiiinnnngggg tttthhhhiiiissss ddddiiiirrrreeeeccccttttiiiivvvveeee]]]]
  339.  
  340.        One possible area to check is your server configuration
  341.        files. Examine the variable MaxThreads in the file
  342.        magnus.conf. The file may be found (for example) in
  343.        /usr/ns-home/httpd-<our_machine>/config.  This variable
  344.        should be set to at least _4 for this operation to function
  345.        properly. You will need to restart your HTTP (web) server
  346.        after modifying this variable.
  347.  
  348.        Refer to your HTTP (web) server's documentation for details.
  349.  
  350.  
  351.        2.7  _E_x_e_c_u_t_i_o_n__A_f_t_e_r__I_n_s_t_a_l_l_a_t_i_o_n
  352.  
  353.        After the software has been installed, you can access the
  354.        InfoSearch content as follows:
  355.  
  356.           %%%% iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh <<<<hhhhoooossssttttnnnnaaaammmmeeee>>>>
  357.  
  358.        Or by this command:
  359.  
  360.           %%%% <<<<wwwweeeebbbb____bbbbrrrroooowwwwsssseeeerrrr>>>> hhhhttttttttpppp::::////////<<<<hhhhoooossssttttnnnnaaaammmmeeee>>>>////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////
  361.  
  362.        Substitute your favorite HTTP (web) browser for
  363.        "<web_browser>" in the previous example. Substitute the name
  364.        of the server containing InfoSearch content for <hostname>
  365.        in both examples.
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.